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Assembler Syntax 



1.1. Introduction Sun Microsystems’ Sun-4 Assembler takes assembly language programs, as 

specified in this document, and produces relocatable object files for processing 
by the Sun-4 link editor. The assembly language described in this document 
corresponds with the SPARC instruction set defined in the SPARC ™ Architecture 
Manual, Version 8, is intended for use on Sun-4s and SPARCStations. 

1.2. Other References You should also become familiar with the manual pages as(l), ld{ 1), cpp{ 1), 

a.out{ 5), and the SPARC Architecture Manual. 

1.3. A Short Example The following example illustrates how a short assembly language program might 

look. 



/* 

* a simple program to copy a string 

* showing correct syntax, delay slots, and use of annul bit. 

* pseudo-operations: .seg, .global, .asciz, .skip 

* synthetic instructions: set, ret, retl, mov, inc, deccc, nop 

* numeric label: 1 

* symbolic substitution: WINDOWSIZE 
*/ 

#include <sun4/asm_linkage .h> 



mam 



.seg "text" 

.global main 






save %sp, -WINDOWSIZE, %sp 

set str, %o 

set out, %ol 

call _bcopy 

mov 24, %o2 


! source string 
! destination location 

! delay slot, length to 


copy 


ret 

restore %o0, 0, %o0 


! return value from main 




.global _bcopy 




J 


# sun 

Xr microsystems 


1 
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1: 


inc 


o 

0 

o\° 


j 


inc from address 




stb 


%o4, [%ol] 


i 


write to address 




inc 


%ol 


j 


in the delay slot : inc to address 


_bcopy : 


deccc 


%o2 


j 


dec count, set condition codes 




bge, a 


lb 


i 


loop until done 




ldub 


[ %o0 ] , %o4 


j 


delay slot, read from address 




retl 




! 


leaf routine return 




nop 




j 


delay slot 




. seg 


"data" 






str : 


.asciz 


"this is a sample string" 








. seg 


"bss" 






out : 

w 


. skip 


30 


t 


reserve 30 bytes 

j 



1.4. Syntax Notation In the descriptions of assembly language syntax in this chapter, brackets “ [ ]” 

enclose optional items, and the star indicates items to be repeated zero or 
more times. Braces “{ }” enclose alternate item choices, which are separated 
from each other by vertical bars Wherever blanks are allowed, arbitrary 
numbers of blanks and horizontal tabs may be used. 



The syntax of assembly language lines is: 




1.5. Statement Syntax The syntax of an assembly language statement is: 




In the above syntax, label is a symbol name (described below), instruction is an 
encoded pseudo-op, synthetic instruction, or instruction, and comment is any text 
up to the line end. 

1.6. Lexical Features This section describes lexical features of the assembler’s syntax. 
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Case Distinction 



Comments 



Numbers 



Strings 



Symbol Names 



Upper and lower case are distinct everywhere, except in the names of special 
symbols (see below), where there is no case distinction. 

A comment is preceded by an exclamation mark; the “ ! ” and all following char- 
acters up to the end of the line are ignored. C-style comments with 
are also permitted, and may span multiple lines. 

Decimal, hexadecimal, and octal numeric constants are recognized, and are writ- 
ten as in the C language. For floating-point pseudo operations, floating-point 
constants are written with Or or OR (for REAL) followed by a string acceptable 
to at of (3): an optional sign followed by a nonempty string of digits with 
optional decimal point and optional exponent, or followed by a special name, as 
shown below. 

The special names Oman and Or inf represent the special floating-point values 
Not-A-Number and INFinity, respectively. Negative Not-A-Number and Nega- 
tive INFinity are specified as Or -nan and Or- inf, respectively. 

NOTE Notice that the names of these floating-point constants begin with a zero, not the 
letter “ O ” 

Strings may be quoted with either double-quote (") or single-quote (') marks. 
When used in an expression, the numeric value of a string is the numeric value of 
the ASCII representation of its first character. 



The suggested style is to use single quote marks for the ASCII value of a single 
character, and double quote marks for quoted-string operands, such as used by 
pseudo-ops. Here is some assembly code in the suggested style: 



( 






\ 


add 


%gl, ' a' -' A' ,%gl 


! gl + ( ' a' - 'A' ) — > gl 




. seg 


"data" 






. ascii 


"a string" 






.byte 


'M' 






V 






J 



The following escape codes are recognized in strings; they are derived from C: 



\b 


backspace 


\f 


formfeed 


\n 


newline (linefeed) 


\r 


carriage return 


\t 


horizontal tab 


\nnn 


octal value nnn 



The syntax for a symbol name is: 



r 














\ 


{ letter | 
V 


- 


1 $ 1 


. } { letter \ 


- 


1 $ 1 


• 1 digit }* 





Upper-case and lower-case letters are distinct, and the underscore, dollar sign, 
and period are treated as alphabetic characters. 
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Symbol names that begin with L are assumed to be compiler-generated local 
symbols, and, to simplify debugging somewhat, are best avoided in hand-coded 
assembly language routines. 

The symbol “ . ” is predefined, and always refers to the address of the beginning 
of the current assembly language statement. 

NOTE By convention, system run-time routine names start with and names from C, 

assembly language and ill begin with a . 

Labels A label is either a symbol or a single decimal digit n (0 ... 9). Note that a label is 

immediately followed by a colon. 

Numeric labels may be defined repeatedly in an assembly, whereas normal sym- 
bolic labels may be defined only once. 

A numeric label n is referenced after its definition (backward reference) as nb, 
and before its definition (forward reference) as ni . 

Special Symbols Special symbol names begin with % so as not to conflict with user symbols, and 

include: 



Table 1-1 Special Symbols 



Symbol Object 


Name 


Comment 


general-purpose registers 


%r0 . 


.. %r31 




general-purpose global registers 


%g0 . 


.. %g7 


( same as %r0 . . . %r7) 


general-purpose “out” registers 


%o0 . 


. . %o7 


(same as %r8 ... %r!5) 


general-purpose “local” registers 


o 

i — i 
o\° 


.. %17 


(same as % r!6 ... %r23) 


general-purpose “in” registers 


%i0 . 


.. %i7 


(same as %r24 ... %r31) 


stack-pointer register 


%sp 




(%sp = %o6 = %14) 


frame-pointer register 


%fp 




(%fp = %i6 = %30) 


floating-point registers 


%f0 . 


.. %f 31 




floating-point status register 


%f sr 






front of floating-point queue 


%f q 






coprocessor registers 


%c0 . 


.. %c31 




coprocessor status register 


%csr 






coprocessor queue 


%cq 






program status register 


%psr 






trap vector base address register 


%tbr 






window invalid mask 


%wim 






Y register 


%y 






unary operators 


%lo 




(extracts least significant 10 bits ) 




%hi 




(extracts most significant 22 bits ) 



There is no case distinction in special symbols; therefore using something like 
%PSR is equivalent to %psr. Use of all lower-case is the suggested style. The 
lack of case distinction allows for the use of non-recursive preprocessor 
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substitutions, such as 



/ 


N 


tdefine psr %PSR 




V 


7 



The special symbols %hi and % lo are true unary operators which can be used in 
any expression, and like other unary operators have higher precedence than 
binary operations. For example: 





%hi a+b s (%hi a)+b 
%lo a+b = (%lo a)+b 




It is a good idea to enclose operands of %hi or %lo in parentheses to avoid 
ambiguity. For example: 




%hi (a) + b 









J 



Operators and Expressions The following operators are recognized in constant expressions: 



Binary Operators 


Unary Operators 


+ Integer Addition 

Integer Subtraction 
* Integer Multiplication 

/ Integer Division 

% Modulo 

Exclusive OR 
« Left Shift 

» Right Shift 

& Bitwise AND 

| Bitwise OR 


+ (no effect) 

2’s Complement 
~ l’s Complement 

%lo (see above) 

%hi (see above) 



Note that the modulo operator % must not be immediately followed by a letter or 
digit, to avoid confusion with register names or with %hi or %lo. The modulo 
operator is typically followed by a space or left parenthesis. 

Although the above operators have the same precedence as in the C language, 
parenthesization of expressions is recommended to avoid ambiguity. 



1.7. as Error Messages Messages generated by the assembler are generally self explanatory and give 

sufficient information to allow one to correct a problem. Certain conditions will 
cause the assembler to issue warnings associated with delay slots following Con- 
trol Transfer Instructions (CTIs): 

□ set instructions in delay slots 

□ labels in delay slots 

□ segments that end in control/transfer instructions 
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These are not necessarily incorrect, but point to places where a problem could 
exist. If you have intentionally written code this way, you can inform the assem- 
bler that you know what you are doing by inserting a pseudo-op in a manner 
similar to a C programmer’s using casts. 

The . empty pseudo-operation in a delay slot tells the assembler that the delay 
slot can be empty or contain whatever follows, because you have verified that 
either the code is correct or the content of the delay slot doesn’t matter. Avoid 
using . empty in assembly-language programs just as you would avoid using 
casts in C programs. The . empty pseudo-operation is used only in programs 
written in assembly language; Sun’s compilers don’t generate it. 
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Instruction-Set Mapping 



The tables in this chapter describe the relationship between hardware instructions 
of the SPARC architecture, as defined in SPARC Processor Architecture, and the 
instruction set used by Sun Microsystems’ SPARC Assembler. 

2.1. Table Notation The following table describes the notation used in the tables in the rest of the 

chapter to describe the instruction set of the assembler. 



Table 2-1 Notation 



Symbol 


Describes 


Comment 


reg 


%r0 . . . %r 31 
%g0 . . . %g7 
%o0 . . . %o7 
%10 . . . %17 
%i0 . . . %i7 


(same as %r0...%r7) 
(same as %r8...%rl5J 
(same as %rl6 . . . %r23J 
(same as %r24 . . . %r31J 


freg 


%f 0 . . . %f 31 




creg 


%c0 . . . %c31 




value 




(an expression involving at most one relocatable symbol ) 


const 13 


value 


(a signed constant which fits in 13 bits ) 


const22 


value 


(a constant which fits in 22 bits) 


asi 


value 


(alternate address space identifier; an unsigned 8-bit value) 


re K d 




Destination register. 


re ^,< re s„2 




Source register 1, source register 2. 


regaddr 


re K, + re «„2 


Address formed with register contents only. 


address 


reg rsl + reg rs2 
reg + const 13 

rsl 

r e 8 rs i ~ const 13 
constl3 + reg 

rsl 

constl3 


Address formed from register contents, 
immediate constant, or both. 




7 
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Table 2-1 Notation — Continued 



Symbol 


Describes 


Comment 


regorimm 


re 8~ 

const!3 


Value from either a single register, or 
an immediate constant. 



2.2. Integer Instructions The following table outlines the correspondence between SPARC hardware 

integer instructions and SPARC assembly language instructions. The following 
notations are suffixed repeatedly to assembler mnemonics (and in upper case for 
SPARC architecture instruction names): 

sr — status register. 

a — instructions dealing with alternate space. 
b — byte instructions. 
h — halfword instructions. 
d — doubleword instructions. 

/ — referencing floating-point registers. 
c — referencing coprocessor registers. 

rd — as a subscript, refers to a destination register in the argument list of an 
instruction. 

rs — as a subscript, refers to a source register in the argument list of an 
instruction. 

NOTE The syntax of individual instructions is designed so that a destination operand (if 

any), which may be either a register or a reference to a memory location, is 
always the last operand in a statement. 

In the table below, curly brackets ( { } ) mark optional arguments. Square brack- 
ets ([] ) mark indirection: the contents of the addressed memory location are 
being read from or written to. 

NOTE All Bicc and Bf cc instructions, described in the following table, may indicate 
that the annul bit is to be set by appending “ , a” to the opcode; e.g. “bgeu , a 
label”. 
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Table 2-2 SPARC to Assembly Language Mapping 



SPARC 


Mnemonic 


Argument List 


Name 


Comments 


ADD 


add 


reg rsl f reg or Jmm, reg rd 


Add 




ADDcc 


addcc 


reg rsi , reg orjmm, reg rd 


Add and modify icc 




ADDX 


addx 


reg nJ , reg_or Jmm, reg ^ 


Add with carry 




ADDXcc 


addxcc 


reg rsi , reg_or Jmm, reg ^ 






AND 


and 


reg rs] , reg or Jmm, reg ^ d 


And 




ANDcc 


andcc 


reg rsi , reg_orJmm, reg d 






ANDN 


andn 


reg rsj , reg or Jmm, reg ^ 






ANDNcc 


andncc 


reg rsj , reg or Jmm, reg ^ 






Bicc 


bn{ , a} 


label 


Branch on integer condi- 


( branch never) 








tion codes 






bne{, a} 


label 




(synonym: bnz ) 




be{, a} 


label 




( synonym : bz) 




bg{, a} 


label 






Bicc 


ble{ , a} 


label 








bge{ , a} 


label 








bl{, a} 


label 








bgu{,a} 


label 








bleu{ , a} 


label 








bcc{ , a} 


label 




( synonym : bgeuj 




bcs{ , a} 


label 




(synonym: bluj 




bpos{ , a} 


label 








bneg{ , a} 


label 








bvc{ , a} 


label 








bvs{ , a} 


label 








ba{ , a} 


label 




(synonym: b) 


CALL 


call 


label { , n } 


(n = # of out registers used 










as arguments ) 




CBccc 


cbn{ , a} 


label 


Branch on coprocessor 


(branch never) 




cb3{ , a} 


label 


condition codes 






cb2 { , a} 


label 








cb23{, a} 


label 








cbl{ , a} 


label 








cbl3{, a} 


label 








cbl2 { , a} 


label 








cbl23 { , a} 


label 








cbO { , a} 


label 








cb03 { , a} 


label 








cb02 { , a} 


label 








cb023 { , a} 


label 








cb01{, a} 


label 








cb013 { , a} 


label 








cb012 { , a} 


label 








cba{, a} 


label 
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Table 2-2 SPARC to Assembly Language Mapping — Continued 



SPARC 


Mnemonic 


Argument List 


Name 


Comments 


FBfcc 


fbn{, a} 


label 


Branch on floating-point 


( branch never) 




fbu{, a} 


label 


condition codes 






fbg{, a} 


label 








fbug{, a} 


label 








fbl{,a} 


label 








fbul{, a} 


label 








fblg{, a} 


label 








fbne{,a} 


label 




(synonym: fbnzj 




fbe{, a} 


label 




(synonym: fbzj 




fbue{, a} 


label 








fbge{, a} 


label 








fbuge{, a} 


label 








fble{, a} 


label 








fbule{, a} 


label 








fbo{, a} 


label 








fba{, a} 


label 






FLUSH 


flush 


address 


Instruction cache flush 




JMPL 


jmpl 


address, reg 

rd 


Jump and link 




LDSB 


ldsb 


[ address ] , reg 


Load signed byte 




LDSH 


ldsh 


[ address ] r re S rd 


Load signed halfword 




LDSTUB 


ldstub 


[address] , reg 


Load-store unsigned byte 




LDUB 


ldub 


[ address ] , reg 


Load unsigned byte 




LDUH 


lduh 


[address] , reg 


Load unsigned halfword 




LD 


Id 


[address] , reg 


Load word 




LDD 


ldd 


[address] , reg 


Load double word 


(reg must be even) 


LDF 


Id 


[address] ,freg 


Load floating-point regis- 










ter 




LDFSR 


Id 


[address] , %f sr 






LDDF 


ldd 


[address] rfreg^ 


Load double floating-point 




LDC 


Id 


[address] , creg 


Load coprocessor 




LDCSR 


Id 


[address] , %csr 






LDDC 


ldd 


[address] , creg d 


Load double coprocessor 




LDSBA 


ldsba 


[ regaddr] asi, reg ^ 


Load signed byte from 










alternate space 




LDSHA 


ldsha 


[ regaddr] asi, reg ^ 






LDUB A 


ldub a 


[ regaddr] asi, reg 






LDUHA 


lduha 


[ regaddr] asi, reg^ 






LDA 


Ida 


[regaddr] asi, reg d 






LDDA 


ldda 


[ regaddr] asi, reg d 




( reg must be even ) 

rd. 


LDSTUBA 


ldstuba 


[ regaddr] asi, reg 
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Table 2-2 SPARC to Assembly Language Mapping — Continued 



SPARC 


Mnemonic 


Argument List 


Name 


Comments 


MULScc 


mulscc 


reg ,reg or imm,reg 


Multiply step (and modify 










icc) 




NOP 


nop 


no operation 




OR 


or 


re g rs i r reg or imm, reg 


Inclusive or 




ORcc 


orcc 


reg^ , reg or imm , reg^ 






ORN 


orn 


reg , reg or imm, reg 

rsl — rd 






ORNcc 


orncc 


reg rs} , reg_or_imm, reg d 






RDASR 


rd 


%asr n rsi ,reg rd 






RDY 


rd 


%Yrreg rd 




(see synthetic instructions ) 


RDPSR 


rd 


%psr ,reg rd 




(see synthetic instructions ) 


RDWIM 


rd 


%wim, reg 




(see synthetic instructions ) 


RDTBR 


rd 


%tbr, reg rd 




(see synthetic instructions ) 


RESTORE 


restore 


reg ,reg or imm, reg 

rsl — ~ rd 




(see synthetic instructions ) 


RETT 


rett 


address 


Return from trap 




SAVE 


save 


reg ,reg or imm, reg 

rsl — rd. 




(see synthetic instructions ) 


SDIV 


sdiv 


reg ,reg or imm, reg 


signed divide 




SDIVcc 


sdiv 


reg rs] , reg or imm, reg rd 


signed divide and modify 










icc 




SMUL 


smul 


reg i , reg_or_imm, reg 


signed multiply 




SMULcc 


smulcc 


reg ,reg or imm, reg 


signed multiply and modify 










icc 




SETHI 


sethi 


const22 , reg 


Set high 22 bits ofr regis- 










ter 






sethi 


%hi {value) , reg 

rd 




(see synthetic instructions) 


SLL 


sll 


reg rsi , reg_or_imm, reg rd 


Shift left logical 




SRL 


srl 


reg ,reg or imm, reg 


Shift right logical 




SRA 


sra 


reg ,reg or imm, reg 

rsl ~ rd 


Shift right arithmetic 




STB 


stb 


regaddr, [address] 


Store byte. 


(synonyms: stub, stsbj 


STH 


sth 


regaddr, [address] 




(synonyms: stuh, stsh) 


ST 


st 


reg rd , [ address ] 






STD 


std 


reg rd , [address] 




(reg d must be even ) 


STF 


st 


freg rdf [address] 






STDF 


std 


freg rd , [address] 






STFSR 


st 


%fsr, [address] 


Store floating-point status 










register 




STDFQ 


std 


%fq, [address] 


Store double floating-point 










queue 




STC 


st 


creg rd , [ address ] 


Store coprocessor 





microsystems 
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Table 2-2 SPARC to Assembly Language Mapping — Continued 



SPARC 


Mnemonic Argument List 


Name 


Comments 


STDC 

STCSR 

STDCQ 


std creg , [address] 

rd 

st %csr, [address] 

std %cq, [ address ] 


Store double coprocessor 
queue 




STBA 

STHA 

STA 

STDA 


stba regaddr, [regaddr]asi 

stha regaddr, [regaddr] asi 

sta re & rd ' t regaddr] asi 

st da reg , [regaddr] asi 


Store byte into alternate 
space 


(synonyms: stub a, 
stsbaj 

(synonyms: stuha, stshaj 
(reg must be even) 

rd. 


1 


sub reg ,reg or imm,reg 

rsl — — rd 

subcc reg ,reg or imm,reg 

rsl rd 

subx reg , reg or imm, reg 

rsl ~ rd 

subxcc reg , reg or imm,reg , 

rsl — — rd 


Subtract 

Subtract and modify icc 
Subtract with carry 




SWAP 

SWAPA 


s wap [ address ] , reg 

rd 

s wapa [ regaddr] asi, reg fd 


Swap memory word 
with register 




Ticc 


tn address 

tne address 

te address 

tg address 

tie address 

tge address 

1 1 address 

tgu address 

tleu address 

t lu address 

tgeu address 

tpos address 

tneg address 

tvc address 

tvs address 

ta address 


Trap on integer condition 
code. (See note.) 


(trap never) 

(synonym: tnz ) 
(synonym: t z) 

(synonym: tccj 
(synonym: tcsj 

(synonym: t ) 


TADDcc 

TSUBcc 

TADDccTV 

TSUBccTV 


taddcc reg . reg or imm, reg . 

rsl rd 

t subcc reg ,reg or imm, reg 

rsl ~ — . rd 

taddcctv reg ,reg or imm, reg 

rsl — rd 

tsubcctv reg ,reg or imm, reg 

rsl ~ rd 


Tagged add and modify icc 

Tagged add and modify icc 
and trap on overflow 




UDIV 

UDIVcc 


u di v reg ' r ^8_ofJmm , reg rd 

udivcc reg ,reg or imm, reg 

rsl ~ ~ rd 


unsigned divide 
unsigned divide and 
modify icc 




UMUL 


umu 1 re 8 rs i r re 8- or J mm r re 8 rd 


unsigned multiply 






microsystems 
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Table 2-2 SPARC to Assembly Language Mapping — Continued 



SPARC 


Mnemonic Argument List 


Name 


Comments 


UMULcc 


umu 1 c c reg ^ , reg_or_imm , 


unsigned multiply and 
modify icc 




UNIMP 


unimp const22 


Unimplemented instruction 




WRASR 

WRY 

WRPSR 

WRWIM 

WRTBR 


wr reg or imm, %asr n 

— — rsl 

w r reg ' re S- or J mm t % Y 

wr reg } , reg or imm, %psr 

wr reg , reg_or_imm, %wim 

wr reg , reg or imm , %tbr 

rsl ~ 




(see synthetic instructions) 
(see synthetic instructions) 
(see synthetic instructions) 
(see synthetic instructions) 


XNOR 

XNORcc 


x n o r re %rsi ' re gJ Dr J mm f re S rd 

x no r c c re S rsl < reg_or_imm , reg rd 


Exclusive nor 




XOR 

XORcc 


xor reg , reg or imm, reg 

rsl ~ — rd 

xorcc reg ,reg or imm, reg 

rsl — rd 


Exclusive or 





NOTE Trap numbers 16-31 are available for use by the user, and will not be usurped by 
Sun. Currently-defined trap numbers are those defined in 
/usr/ include/ sun4/trap . h, as follows: 

0x00 ST_SYSCALL 

0x01 ST_BREAKPOINT 

0x02 ST_DIV0 

0x03 ST_FLUSH_WINDOWS 

0x04 S T_C L E AN_W I ND OW S 

0x05 ST_RANGE_CHECK 

0x06 S T_F I X_AL I GN 

0x07 ST_INT_OVERFLOW 

2.3. Floating-Point In the table below, the types of numbers being manipulated by an instruction are 

Instructions denoted by the following lowercase letters: 

i — integer 

^ — single 

d — double 

q — quad 

In some cases where more than numeric type is involved, each instruction in a 
group is described. Otherwise, only the first member of a group is described. 
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Table 2-3 Floating-point Instructions 



SPARC 


Mnemonic Argument List 


Description 


FiTOs 

FiTOd 

FiTOq 


fitos freg rs2 , freg rd 

fitod freg rs2 , freg rd 

fitoq freg ri2 , freg rd 


Convert integer to single. 
Convert integer to double. 
Convert integer to quad. 


FsTOi 

FdTOi 

FqTOi 


fstoi freg rs2 , freg rd 

fdtoi freg^, freg rd 

fqt°i f re g„ 2 ' fr e s rd 


Convert single to integer. 
Convert double to integer. 
Convert quad to integer. 


FsTOd 

FsTOq 


fstod freg n2 , freg rd 

fstoq freg rs2 , freg rd 


Convert single to double. 
Convert single to quad. 


FdTOs 

FdTOq 


fdtos freg^, freg rd 

fdtoq freg rs2 , freg rd 


Convert double to single. 
Convert double to quad. 


FqTOd 

FqTOs 


fqtod freg rs2 , freg rd 

fqtos freg^, freg rd 


Convert quad to double. 
Convert quad to single. 


FMOVs 

FNEGs 

FABSs 


fmovs f re S rs2 r fr e 8 rd 

fnegs f re 8 rs2 > f re K d 

fabss f re 8 rs2 ' f re 8 rd 


Move 

Negate 

Absolute value 


FSQRTs 

FSQRTd 

FSQRTq 


fsqrts f re 8 rs2 > freg fd 

fsqrtd f re 8 rs2 < freg rd 

fsqrtq f re 8 rs2 ' f re 8 rd 


Square root 


FADDs 

FADDd 

FADDq 


fadds freg aI , freg rs2 , freg rd 

faddd freg rsi , freg rs2 , freg rd 

faddq freg rsl , freg^, freg rd 


Add 


FSUBs 

FSUBd 

FSUBq 


f subs freg rsl , freg rs2 , freg ^ 

fsubd freg ni , freg n2 , freg rd 

fsubx freg rsi , freg rs2 , freg rd 


Subtract 


FMULs 

FMULd 

FMULq 


fmuls freg rsi , freg^, freg^ 

fmuld f re 8 rs] ' f re 8 rs2 ' f re g rd 

fmulq freg^, freg^, freg d 


Multiply 


FdMULq 

FsMULd 


fmulq freg^, freg^, freg rd 

f smuld freg rsl , freg rd2 , freg rd 


Multiply double to quad. 
Multiply single to double. 


FDIVs 

FDIVd 

FDIVq 


fdivs freg^, freg ri2 , freg rd 

fdivd freg^, freg rt2 , freg rd 

fdivq freg^, freg ^ freg rd 


Divide 


FCMPs 

FCMPd 

FCMPq 


fcmps f re 8 rsl r freg rs2 

fcmpd fre£ nI , freg " 

fcmpq freg^, freg ^ 


Compare 
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Table 2-3 Floating-point Instructions — Continued 



SPARC 


Mnemonic Argument List 


Description 


F CMP E s 
FCMPEd 
FCMPEq 


fcmpes freg rsl , freg^ 

fcmped f re S rsl r f re 8 rs2 

fcmpeq f re 8 rsl , freg^ 


Compare, Generate exception if unordered. 



2.4. Coprocessor 
Instructions 



All cpopn instructions take all operands from and return all results to coproces- 
sor registers. The data types supported by the coprocessor are coprocessor- 
dependent. Operand alignment is coprocessor-dependent. 

If the EC field of the PSR is 0, or if no coprocessor is present, a cpop/i instruc- 
tion causes a cp_di s able d trap. 

The conditions causing a cp_exception trap are coprocessor-dependent. 

NOTE A non- cpop n (non-coprocessor-operate) instruction must be executed between 
a cpop2 instruction and a subsequent cbccc instruction. 



Table 2-4 Coprocessor Instructions 



SPARC 


Mnemonic Argument List 


Name 


Comments 


CPopl 

CPop2 


cpopl opd,reg rsi ,reg ri2 ,reg rd 

cpop2 opd, reg rs} , reg ^ , reg rd 


Coprocessor operation 
Coprocessor operation 


(may modify ccc’s) 



2.5. Synthetic Instructions This section describes the mapping of synthetic instructions to hardware instruc- 
tions. 



Table 2-5 Synthetic Instruction to Hardware Instruction Mapping 



Synthetic Instruction 


Hardware Equivalent! s) 


Comment 


cmp 


reg ,reg or imm 

rsl — 


subcc 


reg , reg or imm, %g0 

rsl 


( compare ) 


jmp 


address 


jmpl 


address, %g0 




call 


regorimm 


jmpl 


regjor jmm, %o7 




tst 




orcc 


reg rs i, % g°' %g0 


(test) 


ret 

retl 


jmpl 

jmpl 


%i7+8 , %g0 
%o7+8 , %g0 


(return from subroutine) 

( return from leaf subroutine ) 


restore 

save 


restore 

save 


%g0, %g0, %g0 
%g0, %g0, %g0 


(trivial restore) 

(trivial save) 

Warning: trivial save 
should only be used in kernel 
code! 


set 


value , reg 

rd 


or 


%g0 , value, reg 


(if -4096 < value < 4095) 
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Table 2-5 Synthetic Instruction to Hardware Instruction Mapping — Continued 



Synthetic Instruction 


Hardware Equivalents ) 


Comment 


set 


value, reg 


sethi 


%hi {value) , reg 

rd 


(if ((value&Oxlff) == 0)) 


set 


value , reg rd 


sethi 

or 


%hi {value) , reg ; 
reg d , %lo {value) , reg rd 


( otherwise ) 

Warning: do not use set in 
an instruction’s delay slot. 


not 


reg rsi ' reg rd 


xnor 


reg^igO,^ 


(one’s complement) 


not 


reg rd 


xnor 


reg rd ,%g0,reg rd 


(one’s complement) 


neg 


”**'**« 


sub 


igO,reg ri2 ,reg rd 


(two’s complement) 


neg 


re ^ 


sub 


%qO,reg rd ,re Srd 


(two’ s complement) 


inc 


re s rd 


add 


reg^-L.reg 
reg const! 3, reg 


(increment by 1) 


inc 


constl3 , reg 


add 


(increment by const! 3) 


inccc 




addcc 


reg rd ,l,reg rd 


(increment by 1 and set icc) 


inccc 


const!3,reg 

rd 


addcc 


reg d , const!3,reg d 


(increment by const! 3 and 
set icc) 


dec 


re ^ 


sub 


regrd' 1 r re Srd 


(decrement by 1) 


dec 


const!3, reg 


sub 


reg , const! 3, reg 


(decrement by const! 3) 


deccc 


reg rd 


subcc 


reg rd ,l,reg rd 


(decrement by ! and set icc) 


deccc 


const!3 , reg 

rd 


subcc 


reg d , constl3,reg d 


(decrement by const 13 and 
set icc) 


btst 


reg_or_imm,reg 


andcc 


reg ,reg or imm,%qO 

rsl — 


(bit test) 


bset 


reg_orJmm, reg 


or 


reg rd , reg_or_imm, reg rd 


(bit set) 


bclr 


reg or imm, reg 


andn 


reg d , reg or imm, reg rd 


(bit clear) 


btog 


reg or imm, reg 


xor 


reg d , reg_or Jmm, reg ^ 


(bit toggle) 


clr 


reg A 

[ address ] 


or 


%g0, %g0 ,reg rd 


(clear(zero) register) 


clrb 


stb 


%g0 , [address] 


(clear byte) 


clrh 


[ address ] 


sth 


%g0 , [address] 


(clear halfword) 


clr 


[ address ] 


St 


%g0 , [address] 


(clear word) 


mov 


reg or imm, reg 


or 


%g0 , reg or imm, reg 




mov 


%Y,reg rsl 


rd 


% Y ' reg rsl 




mov 


% P Sr f re g rs i 


rd 


%psr ,re grs] 




mov 


%wim, reg^ 


rd 


%wim / reg 

rsl 




mov 


itbr, reg ^ 


rd 


%tbr , reg 

rsl , 




mov 


reg or imm, %y 


wr 


%g0, reg_or_imm, %y 




mov 


reg or imm , %psr 


wr 


%g0, reg or jmm, %psr 




mov 


reg or imm, %wim 


wr 


%g0, reg or jmm, %wim 




mov 


reg or imm, %tbr 


wr 


% g 0 , reg_orjmm , %tbr 
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2.6. Leaf Procedures Leaf procedures are the outermost routines on the tree of a program, as a tree’s 

leaf is at the end of a stem on the branch of a tree. 

Some leaf procedures can be made to operate without their own register window 
or stack frame, using their caller’s instead. Such a leaf procedure is called an 
optimized leaf procedure. This can be done when the candidate procedure 
meets all of the following conditions: 

□ it contains no CALLS or JMPLs to other procedures 

□ it contains no references to % sp, except in its SAVE instruction 

□ it contains no references to %fp 

□ it refers to, or can be made to refer to, no more than 8 of the 32 integer regis- 
ters, inclusive of %o 7, the “return address”. 

If a procedure conforms to all of the above conditions, it can be made to operate 
using its caller’s stack frame and registers an optimization that saves both time 
and space. When optimized, the procedure may only safely use registers which 
its caller already assumes to be volatile across a procedure call: %o0 ... %o5, 
%o7, and %gl. This may be expanded to registers %gl ... %g7 if SPARC ABI 
compliance isn’t required. 

Leaf routines are most useful when they prevent expensive window 
overflow/underflow situations, saving many tens of cycles each. 
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Pseudo-Operations 



The following pseudo-operations are supported by the Sun-4 assembler: 



Table A-l List of Pseudo-Operations 



Mnemonic 


Arguments) 


Description 


. alias 




Turns off preceding .noalias. (Compiler-generated 
only.) 


. noalias 


%regl , %reg2 


%regl and %reg2 will not alias each other (point to the 
same destination) until a .alias is issued. (Compiler- 
generated only.) 


. ascii 


" string " [ , ” string "] * 


Generates the given sequence(s) of ASCII characters. 


. asciz 


" string " [ , "string " ] * 


Generates the given sequence(s) of ASCII characters, with 
each string followed by a null byte. 


. optim 


" string " 


Any optimization that can also be given as a flag in the com- 
mand line, such as -0 [ n] with n = {0,1, 2, 3}. (Compiler- 
generated only.) 


. seg 


" string " 


Changes the current segment to the one named, and sets the 
location counter to the location of the next available byte in 
that segment. The default segment at the beginning of 
assembly is text. Currently, only segments text, data, 
datal, and bss are supported. 


. skip 


n 


Increments the location counter by n, which allocates n bytes 
of empty space in the current segment. 


. align 


boundary 


Aligns the location counter on a 0-mod -boundary boundary; 
boundary may be 1 (which has no effect), 2, 4, or 8. 


.byte 


8bitval [ , 8bitval ] * 


Generates (a sequence of) initialized bytes in the current seg- 
ment. 


.half 


16bitval [ , 16bitval ] * 


Generates (a sequence of) initialized halfwords in the current 
segment. The location counter must already be aligned on a 
halfword boundary (use .align 2). 
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Table A- 1 List of Pseudo-Operations — Continued 



Mnemonic 


Arguments) 


Description 


.word 


32bitval [ , 32bitval ] * 


Generates (a sequence of) initialized words in the current 
segment. The location counter must already be aligned on a 
word boundary (use .align 4). 


. single 


Or floatval [ , Or floatval] * 


Generates (a sequence of) initialized single-precision 
floating-point values in the current segment. The location 
counter must already be aligned on a word boundary (use 
. align 4). 


. double 


Qvfloatval [ , Or floatval] * 


Generates (a sequence of) initialized double-precision 
floating-point values in the current segment. The location 
counter must already be aligned on a doubleword boundary 
(use . align 8). 


. quad 


Orfloatval [ , Or floatval] * 


Generates (a sequence of) initialized quad-precision 
floating-point values in the current segment ( . quad 
currently generates quad-precision values with only double- 
precision significance). The location counter must already 
be aligned on a doubleword boundary (use . align 8). 


. global 


symbol name [ , symbol _name ] * 


Marks the (list of) user symbols as “global”. Note that when 
a symbol is both declared to be global and defined (that is, 
used as a label, used as the left operand of an = pseudo-op, 
or used as the first operand of a . reserve pseudo-op) in 
the same module, the . global must appear before the 
definition. 


. common 


symbol name , size [ , " segment " ] 


Declares the name and size (in bytes) of a FORTRAN-style 
COMMON area. If "segment" is n bss" or not specified, then 
the common area will appear in either the bss or the data 
segment, depending on how symbol name is defined else- 
where. These are the only choices currently supported. 


. reserve 


symbol name , size 

[ , "segment" [ , boundary ] ] 


Defines symbol symbolname, and reserves size bytes of 
space for it in segment segment (optionally aligned on a 
boundary - byte address boundary). This is equivalent to: 
. seg "segment" 

[.align boundary ] 
symbol name: .skip size 

.seg " < previous segment > " 

If "segment" is not specified, space is reserved in the 
current segment. 


. empty 




Used in the delay slot of a Control Transfer Instruction 
(CTI), this suppresses assembler complaints about the next 
instruction’s presence in a delay slot. Some instructions 
should not be in the delay slot of a CTI. See the SPARC 
Architecture Manual for details. 
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Table A- 1 List of Pseudo-Operations — Continued 



Mnemonic 


Arguments) 


Description 


.proc 


n 


Signals the beginning of a “procedure” (unit of optimization) 
to the peephole optimizer in the Sun-4 assembler; n specifies 
which registers will contain useful information upon return 
from the procedure, as follows: 

0 no return value 

6 return value in % f 0 

7 return value in % f 0 and % f 1 

( other ) return value in % i 0 (caller’ s %o 0) 

The pseudo-operation .proc may be produced by code 
generators for higher-level languages. See note below. 


. stabs 


"string" , const4, 0, constl6, const32 


Inserts a symbol table entry consisting of " string ", followed 
by a 4-bit constant const4, a literal zero, a 16-bit constant 
constl6, and a 32-bit constant const32. Used by Sun com- 
pilers only to pass information through the object file to 
symbolic debuggers. 


. stabn 


const4, 0, const!6, const32 


Inserts a symbol table entry consisting of a 4-bit numeric 
entry const4, followed by a literal zero, a 16-bit constant 
constl6, and a 32-bit constant const32. Used by Sun com- 
pilers only to pass line-number information through the 
object file to symbolic debuggers. 


. stabd 


const4, 0, constl6 


Inserts a symbol-table entry consisting of a 4-bit numeric 
entry const4 , followed by a literal zero and a 16-bit constant 
constl6. Used by Sun compilers only to pass location- 
counter information through the object file to symbolic 
debuggers. 


= 


symbolname = constantexpression 


Assigns the value of constant expression to symbol name. 



NOTE Since peephole optimization is not performed on hand-written assembly- 
language code, there is no need for .proc statements in such code. 
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B 






The Sun-4 Assembler 



You invoke as as follows: 







A 




as [options] [ inputfile ] . . . 




v 




J 



as translates the assembly language source files, inputfile into an executable 
object file, objfile. The Sun-4 assembler recognizes the filename argument as 
the standard input. 

All undefined symbols in the assembly are treated as global. 

The Sun-4 assembler supports macros, # include files, and symbolic substitu- 
tion through use of the C preprocessor cpp. The assembler invokes the prepro- 
cessor before assembly begins if it has been specified from the command line as 
an option (see -P below). 

B.l. as Options -L Save defined labels beginning with an L, which are normally discarded to 

save space in the resultant symbol table. The compilers generate many such 
temporary labels. 

-R Make the initialized data segment read-only by concatenating it to the text 
segment. 

-o objfile 

The next argument is taken as the name of the object file to be produced. If 
the -o flag isn’t used, the object file is named a . out. 

-P Run cpp, the C preprocessor, on the files being assembled. The preproces- 
sor is run separately on each input file, not on their concatenation. The 
preprocessor output is passed to the assembler. 



-k Generate position-independent code as required by 



r 




\ 




cc -pic/-PIC 




L 




J 



WARNING 



Don’t apply the -k flag to hand-coded assembler programs unless they are 
written to be position-independent. 
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